| 1 | /* $NetBSD: postconf.c,v 1.2 2017/02/14 01:16:46 christos Exp $ */ |
| 2 | |
| 3 | /*++ |
| 4 | /* NAME |
| 5 | /* postconf 1 |
| 6 | /* SUMMARY |
| 7 | /* Postfix configuration utility |
| 8 | /* SYNOPSIS |
| 9 | /* .fi |
| 10 | /* .ti -4 |
| 11 | /* \fBManaging main.cf:\fR |
| 12 | /* |
| 13 | /* \fBpostconf\fR [\fB-dfhHnopvx\fR] [\fB-c \fIconfig_dir\fR] |
| 14 | /* [\fB-C \fIclass,...\fR] [\fIparameter ...\fR] |
| 15 | /* |
| 16 | /* \fBpostconf\fR [\fB-epv\fR] [\fB-c \fIconfig_dir\fR] |
| 17 | /* \fIparameter\fB=\fIvalue ...\fR |
| 18 | /* |
| 19 | /* \fBpostconf\fR \fB-#\fR [\fB-pv\fR] [\fB-c \fIconfig_dir\fR] |
| 20 | /* \fIparameter ...\fR |
| 21 | /* |
| 22 | /* \fBpostconf\fR \fB-X\fR [\fB-pv\fR] [\fB-c \fIconfig_dir\fR] |
| 23 | /* \fIparameter ...\fR |
| 24 | /* |
| 25 | /* .ti -4 |
| 26 | /* \fBManaging master.cf service entries:\fR |
| 27 | /* |
| 28 | /* \fBpostconf\fR \fB-M\fR [\fB-fovx\fR] [\fB-c \fIconfig_dir\fR] |
| 29 | /* [\fIservice\fR[\fB/\fItype\fR]\fI ...\fR] |
| 30 | /* |
| 31 | /* \fBpostconf\fR \fB-M\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR] |
| 32 | /* \fIservice\fB/\fItype\fB=\fIvalue ...\fR |
| 33 | /* |
| 34 | /* \fBpostconf\fR \fB-M#\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] |
| 35 | /* \fIservice\fB/\fItype ...\fR |
| 36 | /* |
| 37 | /* \fBpostconf\fR \fB-MX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] |
| 38 | /* \fIservice\fB/\fItype ...\fR |
| 39 | /* |
| 40 | /* .ti -4 |
| 41 | /* \fBManaging master.cf service fields:\fR |
| 42 | /* |
| 43 | /* \fBpostconf\fR \fB-F\fR [\fB-fhHovx\fR] [\fB-c \fIconfig_dir\fR] |
| 44 | /* [\fIservice\fR[\fB/\fItype\fR[\fB/\fIfield\fR]]\fI ...\fR] |
| 45 | /* |
| 46 | /* \fBpostconf\fR \fB-F\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR] |
| 47 | /* \fIservice\fB/\fItype\fB/\fIfield\fB=\fIvalue ...\fR |
| 48 | /* |
| 49 | /* .ti -4 |
| 50 | /* \fBManaging master.cf service parameters:\fR |
| 51 | /* |
| 52 | /* \fBpostconf\fR \fB-P\fR [\fB-fhHovx\fR] [\fB-c \fIconfig_dir\fR] |
| 53 | /* [\fIservice\fR[\fB/\fItype\fR[\fB/\fIparameter\fR]]\fI ...\fR] |
| 54 | /* |
| 55 | /* \fBpostconf\fR \fB-P\fR [\fB-ev\fR] [\fB-c \fIconfig_dir\fR] |
| 56 | /* \fIservice\fB/\fItype\fB/\fIparameter\fB=\fIvalue ...\fR |
| 57 | /* |
| 58 | /* \fBpostconf\fR \fB-PX\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] |
| 59 | /* \fIservice\fB/\fItype\fB/\fIparameter ...\fR |
| 60 | /* |
| 61 | /* .ti -4 |
| 62 | /* \fBManaging bounce message templates:\fR |
| 63 | /* |
| 64 | /* \fBpostconf\fR \fB-b\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] |
| 65 | /* [\fItemplate_file\fR] |
| 66 | /* |
| 67 | /* \fBpostconf\fR \fB-t\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] |
| 68 | /* [\fItemplate_file\fR] |
| 69 | /* |
| 70 | /* .ti -4 |
| 71 | /* \fBManaging TLS features:\fR |
| 72 | /* |
| 73 | /* \fBpostconf\fR \fB-T \fImode\fR [\fB-v\fR] [\fB-c \fIconfig_dir\fR] |
| 74 | /* |
| 75 | /* .ti -4 |
| 76 | /* \fBManaging other configuration:\fR |
| 77 | /* |
| 78 | /* \fBpostconf\fR \fB-a\fR|\fB-A\fR|\fB-l\fR|\fB-m\fR [\fB-v\fR] |
| 79 | /* [\fB-c \fIconfig_dir\fR] |
| 80 | /* DESCRIPTION |
| 81 | /* By default, the \fBpostconf\fR(1) command displays the |
| 82 | /* values of \fBmain.cf\fR configuration parameters, and warns |
| 83 | /* about possible mis-typed parameter names (Postfix 2.9 and later). |
| 84 | /* It can also change \fBmain.cf\fR configuration |
| 85 | /* parameter values, or display other configuration information |
| 86 | /* about the Postfix mail system. |
| 87 | /* |
| 88 | /* Options: |
| 89 | /* .IP \fB-a\fR |
| 90 | /* List the available SASL server plug-in types. The SASL |
| 91 | /* plug-in type is selected with the \fBsmtpd_sasl_type\fR |
| 92 | /* configuration parameter by specifying one of the names |
| 93 | /* listed below. |
| 94 | /* .RS |
| 95 | /* .IP \fBcyrus\fR |
| 96 | /* This server plug-in is available when Postfix is built with |
| 97 | /* Cyrus SASL support. |
| 98 | /* .IP \fBdovecot\fR |
| 99 | /* This server plug-in uses the Dovecot authentication server, |
| 100 | /* and is available when Postfix is built with any form of SASL |
| 101 | /* support. |
| 102 | /* .RE |
| 103 | /* .IP |
| 104 | /* This feature is available with Postfix 2.3 and later. |
| 105 | /* .IP \fB-A\fR |
| 106 | /* List the available SASL client plug-in types. The SASL |
| 107 | /* plug-in type is selected with the \fBsmtp_sasl_type\fR or |
| 108 | /* \fBlmtp_sasl_type\fR configuration parameters by specifying |
| 109 | /* one of the names listed below. |
| 110 | /* .RS |
| 111 | /* .IP \fBcyrus\fR |
| 112 | /* This client plug-in is available when Postfix is built with |
| 113 | /* Cyrus SASL support. |
| 114 | /* .RE |
| 115 | /* .IP |
| 116 | /* This feature is available with Postfix 2.3 and later. |
| 117 | /* .IP "\fB-b\fR [\fItemplate_file\fR]" |
| 118 | /* Display the message text that appears at the beginning of |
| 119 | /* delivery status notification (DSN) messages, replacing |
| 120 | /* $\fBname\fR expressions with actual values as described in |
| 121 | /* \fBbounce\fR(5). |
| 122 | /* |
| 123 | /* To override the built-in templates, specify a template file |
| 124 | /* name at the end of the \fBpostconf\fR(1) command line, or |
| 125 | /* specify a file name in \fBmain.cf\fR with the |
| 126 | /* \fBbounce_template_file\fR parameter. |
| 127 | /* |
| 128 | /* To force selection of the built-in templates, specify an |
| 129 | /* empty template file name on the \fBpostconf\fR(1) command |
| 130 | /* line (in shell language: ""). |
| 131 | /* |
| 132 | /* This feature is available with Postfix 2.3 and later. |
| 133 | /* .IP "\fB-c \fIconfig_dir\fR" |
| 134 | /* The \fBmain.cf\fR configuration file is in the named directory |
| 135 | /* instead of the default configuration directory. |
| 136 | /* .IP "\fB-C \fIclass,...\fR" |
| 137 | /* When displaying \fBmain.cf\fR parameters, select only |
| 138 | /* parameters from the specified class(es): |
| 139 | /* .RS |
| 140 | /* .IP \fBbuiltin\fR |
| 141 | /* Parameters with built-in names. |
| 142 | /* .IP \fBservice\fR |
| 143 | /* Parameters with service-defined names (the first field of |
| 144 | /* a \fBmaster.cf\fR entry plus a Postfix-defined suffix). |
| 145 | /* .IP \fBuser\fR |
| 146 | /* Parameters with user-defined names. |
| 147 | /* .IP \fBall\fR |
| 148 | /* All the above classes. |
| 149 | /* .RE |
| 150 | /* .IP |
| 151 | /* The default is as if "\fB-C all\fR" is |
| 152 | /* specified. |
| 153 | /* |
| 154 | /* This feature is available with Postfix 2.9 and later. |
| 155 | /* .IP \fB-d\fR |
| 156 | /* Print \fBmain.cf\fR default parameter settings instead of |
| 157 | /* actual settings. |
| 158 | /* Specify \fB-df\fR to fold long lines for human readability |
| 159 | /* (Postfix 2.9 and later). |
| 160 | /* .IP \fB-e\fR |
| 161 | /* Edit the \fBmain.cf\fR configuration file, and update |
| 162 | /* parameter settings with the "\fIname=value\fR" pairs on the |
| 163 | /* \fBpostconf\fR(1) command line. |
| 164 | /* |
| 165 | /* With \fB-M\fR, edit the \fBmaster.cf\fR configuration file, |
| 166 | /* and replace one or more service entries with new values as |
| 167 | /* specified with "\fIservice/type=value\fR" on the \fBpostconf\fR(1) |
| 168 | /* command line. |
| 169 | /* |
| 170 | /* With \fB-F\fR, edit the \fBmaster.cf\fR configuration file, |
| 171 | /* and replace one or more service fields with new values as |
| 172 | /* specied with "\fIservice/type/field=value\fR" on the |
| 173 | /* \fBpostconf\fR(1) command line. Currently, the "command" |
| 174 | /* field contains the command name and command arguments. this |
| 175 | /* may change in the near future, so that the "command" field |
| 176 | /* contains only the command name, and a new "arguments" |
| 177 | /* pseudofield contains the command arguments. |
| 178 | /* |
| 179 | /* With \fB-P\fR, edit the \fBmaster.cf\fR configuration file, |
| 180 | /* and add or update one or more service parameter settings |
| 181 | /* (-o parameter=value settings) with new values as specied |
| 182 | /* with "\fIservice/type/parameter=value\fR" on the \fBpostconf\fR(1) |
| 183 | /* command line. |
| 184 | /* |
| 185 | /* In all cases the file is copied to a temporary file then |
| 186 | /* renamed into place. Specify quotes to protect special |
| 187 | /* characters and whitespace on the \fBpostconf\fR(1) command |
| 188 | /* line. |
| 189 | /* |
| 190 | /* The \fB-e\fR option is no longer needed with Postfix version |
| 191 | /* 2.8 and later. |
| 192 | /* .IP \fB-f\fR |
| 193 | /* Fold long lines when printing \fBmain.cf\fR or \fBmaster.cf\fR |
| 194 | /* configuration file entries, for human readability. |
| 195 | /* |
| 196 | /* This feature is available with Postfix 2.9 and later. |
| 197 | /* .IP \fB-F\fR |
| 198 | /* Show \fBmaster.cf\fR per-entry field settings (by default |
| 199 | /* all services and all fields), formatted as |
| 200 | /* "\fIservice/type/field=value\fR", one per line. Specify |
| 201 | /* \fB-Ff\fR to fold long lines. |
| 202 | /* |
| 203 | /* Specify one or more "\fIservice/type/field\fR" instances |
| 204 | /* on the \fBpostconf\fR(1) command line to limit the output |
| 205 | /* to fields of interest. Trailing parameter name or service |
| 206 | /* type fields that are omitted will be handled as "*" wildcard |
| 207 | /* fields. |
| 208 | /* |
| 209 | /* This feature is available with Postfix 2.11 and later. |
| 210 | /* .IP \fB-h\fR |
| 211 | /* Show parameter or attribute values without the "\fIname\fR |
| 212 | /* = " label that normally precedes the value. |
| 213 | /* .IP \fB-H\fR |
| 214 | /* Show parameter or attribute names without the " = \fIvalue\fR" |
| 215 | /* that normally follows the name. |
| 216 | /* |
| 217 | /* This feature is available with Postfix 3.1 and later. |
| 218 | /* .IP \fB-l\fR |
| 219 | /* List the names of all supported mailbox locking methods. |
| 220 | /* Postfix supports the following methods: |
| 221 | /* .RS |
| 222 | /* .IP \fBflock\fR |
| 223 | /* A kernel-based advisory locking method for local files only. |
| 224 | /* This locking method is available on systems with a BSD |
| 225 | /* compatible library. |
| 226 | /* .IP \fBfcntl\fR |
| 227 | /* A kernel-based advisory locking method for local and remote |
| 228 | /* files. |
| 229 | /* .IP \fBdotlock\fR |
| 230 | /* An application-level locking method. An application locks |
| 231 | /* a file named \fIfilename\fR by creating a file named |
| 232 | /* \fIfilename\fB.lock\fR. The application is expected to |
| 233 | /* remove its own lock file, as well as stale lock files that |
| 234 | /* were left behind after abnormal program termination. |
| 235 | /* .RE |
| 236 | /* .IP \fB-m\fR |
| 237 | /* List the names of all supported lookup table types. In |
| 238 | /* Postfix configuration files, lookup tables are specified |
| 239 | /* as \fItype\fB:\fIname\fR, where \fItype\fR is one of the |
| 240 | /* types listed below. The table \fIname\fR syntax depends on |
| 241 | /* the lookup table type as described in the DATABASE_README |
| 242 | /* document. |
| 243 | /* .RS |
| 244 | /* .IP \fBbtree\fR |
| 245 | /* A sorted, balanced tree structure. Available on systems |
| 246 | /* with support for Berkeley DB databases. |
| 247 | /* .IP \fBcdb\fR |
| 248 | /* A read-optimized structure with no support for incremental |
| 249 | /* updates. Available on systems with support for CDB databases. |
| 250 | /* .IP \fBcidr\fR |
| 251 | /* A table that associates values with Classless Inter-Domain |
| 252 | /* Routing (CIDR) patterns. This is described in \fBcidr_table\fR(5). |
| 253 | /* .IP \fBdbm\fR |
| 254 | |
|---|